Oracle TimesTen In-Memory Database C開発者およびリファレンス・ガイド

XLA関数について

リターン・コードについて

この章で説明するすべてのXLA API関数は、SQLRETURN型の値を返します。この値は、ODBCによって次のいずれかの値になるように定義されています。

SQL_SUCCESS

SQL_SUCCESS_WITH_INFO

SQL_NO_DATA_FOUND

SQL_ERROR

XLAエラーの処理方法については、「XLAエラーの処理」を参照してください。

パラメータ・タイプ（input、out、inout）について

関数の説明では、次のことに注意してください。

特に指定されていないかぎり、すべてのパラメータは入力専用パラメータです。

出力パラメータには単語outが接頭辞として付けられています。

入出力パラメータには単語inoutが接頭辞として付けられています。

関数による出力結果について

このAPIのほとんどのルーチンは、結果をアプリケーション・バッファにコピーします。結果が含まれているバッファへのポインタを生成する一部のルーチンは、同じXLAハンドルを使用した次のコールが実行されるまでのみ有効性が保証されます。

このルールには次の例外があります。

診断情報を提供するttXlaError関数へのコール間では、バッファは有効なままです。

ttXlaNextUpdateによって返された結果は、次にttXlaNextUpdate、ttXlaConfigBufferまたはttXlaAcknowledge（永続モード）をコールするまで有効なままです。アプリケーションでバッファへのアクセスを長時間維持する必要がある場合は、XLAによって返されるバッファの情報をアプリケーション専用のバッファにコピーする必要があります。

実際の列値を除き、XLA内の文字列値はヌル文字で終了します。固定長のCHAR列は、その長さに合せて空白が埋め込まれます。VARCHAR列は、長さが明示的にエンコードされています。

XLAは、32ビットおよび64ビットの両方のプラットフォームに同じデータ構造を使用します。SQLUINTEGERおよびSQLUBIGINT型を使用して、32ビットおよび64ビットの整数が明示的に参照されます。各SQLUINTEGER値が4バイト境界、各SQLUBIGINT値が8バイト境界に存在するようにtypedefに入力することによって、位置合せおよび埋込みの問題に対処します。他のTimesTenデータ型の記憶域要件については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の行の理解に関する項を参照してください。